<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
	<title>Kepler: The Lua Web Development Platform</title>
    <link rel="stylesheet" href="http://www.keplerproject.org/doc.css" type="text/css"/>
	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
</head>

<body>

<div id="container">

<div id="product">
	<div id="product_logo"><a href="http://www.keplerproject.org">
		<img alt="Kepler" src="kepler.png"/>
	</a></div>
	<div id="product_name"><big><strong>Kepler</strong></big></div>
	<div id="product_description">The Lua Web Development Platform</div>
</div> <!-- id="product" -->

<div id="main">
	
<div id="navigation">
<h1>Kepler</h1>
	<ul>
		<li><a href="index.html">Home</a>
			<ul>
				<li><a href="index.html#overview">Overview</a></li>
				<li><a href="index.html#status">Status</a></li>
				<li><a href="index.html#download">Download</a></li>
				<li><a href="index.html#history">History</a></li>
				<li><a href="index.html#credits">Credits</a></li>
				<li><a href="index.html#contact">Contact us</a></li>
			</ul>
		</li>
		<li><a href="install.html">Installation</a>
            <ul>
                <li><a href="install.unix.html">Unix/OSX</a>
                    <ul>
                        <li><a href="install.unix.html#introduction">Introduction</a></li>
                        <li><a href="install.unix.apache2.html">Apache 2</a></li>
                        <li><a href="install.unix.lighttpd.html">Lighttpd</a></li>
                        <li><strong>Xavante</strong></li>
                    </ul>
                </li>
                <li><a href="install.windows.html">Windows</a></li>
            </ul>
        </li>
        <li><a href="manual.html">Manual</a>
			<ul>
				<li><a href="manual.html#introduction">Introduction</a></li>
				<li><a href="manual.html#configuration">Configuration</a></li>
			</ul>
		</li>
		<li><a href="reference.html">Reference</a></li>
		<li><a href="examples.html">Examples</a></li>
        <li><a href="http://luaforge.net/projects/kepler/">Project</a>
            <ul>
                <li><a href="bugtracker.html">Bug Trackers</a></li>
                <li><a href="http://luaforge.net/scm/?group_id=104">CVS</a></li>
            </ul>
        </li>
		<li><a href="license.html">License</a></li>
	</ul>
</div> <!-- id="navigation" -->

<div id="content">

<h2>Using Xavante</h2>

<p>
Assuming that you have installed Xavante using the default configuration,
you can start Xavante using:
</p>

<pre class="example">
xavante_start
</pre>

<p>
If everything is working, this will display a message stating the correct
initialization of Xavante and the port being used. The default configuration
uses port 8080, so to test if everything is correct just open on you browser
the URL below
</p>

<pre class="example">
http://localhost:8080
</pre>

<p>
If your configuration uses a different port number, then you'll have to use
the corresponding URL change.</p>

<p>
Opening this URL should show the Kepler welcome page. This page displays
a welcome message and allows you to check the documentation and some tests.
</p>

<h2>Configuring Xavante</h2>

<p>
The configuration file for Xavante is located at
&lt;<em>KEPLER_CONF</em>&gt;/xavante/config.lua, the one for CGILua is at
&lt;<em>KEPLER_CONF</em>&gt;/cgilua/config.lua and the public web directory is
&lt;<em>KEPLER_WEB</em>&gt;.
</p>

<p>
You can use the Xavante configuration to change your port and how Xavante should handle HTTP requests.
</p>

<p>
In &lt;<em>KEPLER_WEB</em>&gt; you will find some examples of Lua Pages and Lua Scripts.
<code>index.lp</code> is the page used as a default when opening the starting
URL as shown above. You can replace this file with your own version of the starting
page. You can also use other files in the &lt;<em>KEPLER_WEB</em>&gt; directory and access
them using the format:
</p>

<pre class="example">
http://localhost:8080/mypage.lp
</pre>

<p>or</p>

<pre class="example">
http://localhost:8080/mypage.lua
</pre>

<p>
For more details on how to configure CGILua and use Lua Pages and Lua Scripts please
check the
<a href="http://www.keplerproject.org/cgilua/manual.html">CGILua documentation</a>.
Note that changes to CGILua configuration can impact other launchers installed,
not only Xavante.
</p>

</div> <!-- id="content" -->

</div> <!-- id="main" -->

<div id="about">
	<p><a href="http://validator.w3.org/check?uri=referer">Valid XHTML 1.0!</a></p>
	<p><small>$Id: install.unix.xavante.html,v 1.11 2007/11/19 20:22:03 hisham Exp $</small></p>
</div> <!-- id="about" -->

</div> <!-- id="container" -->

</body>
</html>











